<html lang="en-US">

<head>
    
<title>会诱发 Goroutine 挂起的 27 个原因 - 花落雨忧</title>

<meta property="og:title" content="会诱发 Goroutine 挂起的 27 个原因 - 花落雨忧">



    



    
    <meta property="description" content="大家好，我是煎鱼。
上个月面向读者的提问，我们针对 goroutine 泄露中都会看到的大头 runtime.gopark 函数进行了学习和了解，输出了 《Goroutine 一泄露就看到他，这是个什么？》。
有小伙伴提到，虽然我们知道了 runtime.gopark 函数的缘起和内在，但其实没有提到 runtime.gopark 的诱发因素，这是我们日常编码中需要关注的。
今天这篇文章就和大家一 &amp;hellip;">
    <meta property="og:description" content="大家好，我是煎鱼。
上个月面向读者的提问，我们针对 goroutine 泄露中都会看到的大头 runtime.gopark 函数进行了学习和了解，输出了 《Goroutine 一泄露就看到他，这是个什么？》。
有小伙伴提到，虽然我们知道了 runtime.gopark 函数的缘起和内在，但其实没有提到 runtime.gopark 的诱发因素，这是我们日常编码中需要关注的。
今天这篇文章就和大家一 &amp;hellip;">
    






<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="width=device-width,initial-scale=1">

<link rel="shortcut icon" href="https://www.lican.site/logo/logo.png" type="image/x-icon" />



<link rel="stylesheet" href="/css/style.min.css" />

<link rel="stylesheet" href="/css/reset.min.css" />




<script src="https://www.lican.site/js/highlight.min.js"></script>

<script>
hljs.configure({ ignoreUnescapedHTML: true })
hljs.highlightAll();
</script>


<script src="https://www.lican.site/js/jquery.min.js"></script>




<link href="https://www.lican.site/css/hugo-code.min.css" rel="stylesheet" />



    <style>
        .post-content img {
            max-width: 400px;
        }
    </style>
</head>

<body id="period" class="home blog">
    <a class="skip-content" href="#main">Press "Enter" to skip to content</a>
    <div id="overflow-container" class="overflow-container">
        <header class="site-header" id="site-header" role="banner">
    <div class="max-width">
        <div id="title-container" class="title-container">
            <div id="site-title" class="site-title"><a href="/">花落雨忧</a></div>
            <p class="tagline">思所及 力所行 方为真.</p>
        </div>
        
        <div id="menu-primary-container" class="menu-primary-container">
            <div class="icon-container">
            </div>
            <div id="menu-primary" class="menu-container menu-primary" role="navigation">
                <nav class="menu">
                    <ul id="menu-primary-items" class="menu-primary-items">
                        
                        
                        <li id="menu-item-0"
                            class="menu-item menu-item-type-custom menu-item-object-custom ">
                            <a href="/posts" aria-current="page" tabindex="0">首页</a></li>
                        
                        <li id="menu-item-1"
                            class="menu-item menu-item-type-custom menu-item-object-custom ">
                            <a href="/tech/" aria-current="page" tabindex="1">技术文档</a></li>
                        
                        <li id="menu-item-2"
                            class="menu-item menu-item-type-custom menu-item-object-custom ">
                            <a href="/article/" aria-current="page" tabindex="2">文章</a></li>
                        
                        <li id="menu-item-3"
                            class="menu-item menu-item-type-custom menu-item-object-custom ">
                            <a href="/project/" aria-current="page" tabindex="3">项目</a></li>
                        
                        <li id="menu-item-4"
                            class="menu-item menu-item-type-custom menu-item-object-custom ">
                            <a href="/about/" aria-current="page" tabindex="4">关于</a></li>
                        
                    </ul>
                </nav>
            </div>
        </div>
    </div>
</header>
        <div id="primary-container" class="primary-container">
            <div class="max-width">
                <section id="main" class="main" role="main">
                    <div id="loop-container" class="loop-container">
                        <div
                            class="post type-post status-publish format-standard hentry entry">
                            <article>
                                <div class="post-container">
                                    <div class="post-header">
                                        <h2 class="post-title">
                                            <a href="/posts/go/goroutine-27/">会诱发 Goroutine 挂起的 27 个原因</a>
                                        </h2>
                                        
                                        <div class="post-byline">Published on
                                            <a class="date" href="javascript:;">2021/12/31</a>
                                            
                                            
                                            
                                            
                                            
                                        
                                    </div>
                                    <div class="post-content">
                                        <p>大家好，我是煎鱼。</p>
<p>上个月面向读者的提问，我们针对 goroutine 泄露中都会看到的大头 runtime.gopark 函数进行了学习和了解，输出了 《<a href="https://mp.weixin.qq.com/s/x6Kzn7VA1wUz7g8txcBX7A">Goroutine 一泄露就看到他，这是个什么？</a>》。</p>
<p>有小伙伴提到，虽然我们知道了 runtime.gopark 函数的缘起和内在，但其实没有提到 <strong>runtime.gopark 的诱发因素，这是我们日常编码中需要关注的</strong>。</p>
<p>今天这篇文章就和大家一起围观 gopark 的 27 个诱发场景。为了方便阅读，我们会根据分类进行说明。</p>
<h3 id="第一部分">第一部分</h3>
<table>
<thead>
<tr>
<th>标识</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>waitReasonZero</td>
<td>无</td>
</tr>
<tr>
<td>waitReasonGCAssistMarking</td>
<td>GC assist marking</td>
</tr>
<tr>
<td>waitReasonIOWait</td>
<td>IO wait</td>
</tr>
</tbody>
</table>
<ul>
<li>waitReasonZero：无正式解释，从使用情况来看。主要在 sleep 和 lock 的 2 个场景中使用。</li>
<li>waitReasonGCAssistMarking：GC 辅助标记阶段会使得阻塞等待。</li>
<li>waitReasonIOWait：IO 阻塞等待时，例如：网络请求等。</li>
</ul>
<h3 id="第二部分">第二部分</h3>
<table>
<thead>
<tr>
<th>标识</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>waitReasonChanReceiveNilChan</td>
<td>chan receive (nil chan)</td>
</tr>
<tr>
<td>waitReasonChanSendNilChan</td>
<td>chan send (nil chan)</td>
</tr>
</tbody>
</table>
<ul>
<li>waitReasonChanReceiveNilChan：对未初始化的 channel 进行读操作。</li>
<li>waitReasonChanSendNilChan：对未初始化的 channel 进行写操作。</li>
</ul>
<h3 id="第三部分">第三部分</h3>
<table>
<thead>
<tr>
<th>标识</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>waitReasonDumpingHeap</td>
<td>dumping heap</td>
</tr>
<tr>
<td>waitReasonGarbageCollection</td>
<td>garbage collection</td>
</tr>
<tr>
<td>waitReasonGarbageCollectionScan</td>
<td>garbage collection scan</td>
</tr>
</tbody>
</table>
<ul>
<li>waitReasonDumpingHeap：对 Go Heap 堆 dump 时，这个的使用场景仅在 runtime.debug 时，也就是常见的 pprof 这一类采集时阻塞。</li>
<li>waitReasonGarbageCollection：在垃圾回收时，主要场景是 GC 标记终止（GC Mark Termination）阶段时触发。</li>
<li>waitReasonGarbageCollectionScan：在垃圾回收扫描时，主要场景是 GC 标记（GC Mark）扫描 Root 阶段时触发。</li>
</ul>
<h3 id="第四部分">第四部分</h3>
<table>
<thead>
<tr>
<th>标识</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>waitReasonPanicWait</td>
<td>panicwait</td>
</tr>
<tr>
<td>waitReasonSelect</td>
<td>select</td>
</tr>
<tr>
<td>waitReasonSelectNoCases</td>
<td>select (no cases)</td>
</tr>
</tbody>
</table>
<ul>
<li>waitReasonPanicWait：在 main goroutine 发生 panic 时，会触发。</li>
<li>waitReasonSelect：在调用关键字 select 时会触发。</li>
<li>waitReasonSelectNoCases：在调用关键字 select 时，若一个 case 都没有，会直接触发。</li>
</ul>
<h3 id="第五部分">第五部分</h3>
<table>
<thead>
<tr>
<th>标识</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>waitReasonGCAssistWait</td>
<td>GC assist wait</td>
</tr>
<tr>
<td>waitReasonGCSweepWait</td>
<td>GC sweep wait</td>
</tr>
<tr>
<td>waitReasonGCScavengeWait</td>
<td>GC scavenge wait</td>
</tr>
</tbody>
</table>
<ul>
<li>waitReasonGCAssistWait：GC 辅助标记阶段中的结束行为，会触发。</li>
<li>waitReasonGCSweepWait：GC 清扫阶段中的结束行为，会触发。</li>
<li>waitReasonGCScavengeWait：GC scavenge 阶段的结束行为，会触发。GC Scavenge 主要是新空间的垃圾回收，是一种经常运行、快速的 GC，负责从新空间中清理较小的对象。</li>
</ul>
<h3 id="第六部分">第六部分</h3>
<table>
<thead>
<tr>
<th>标识</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>waitReasonChanReceive</td>
<td>chan receive</td>
</tr>
<tr>
<td>waitReasonChanSend</td>
<td>chan send</td>
</tr>
<tr>
<td>waitReasonFinalizerWait</td>
<td>finalizer wait</td>
</tr>
</tbody>
</table>
<ul>
<li>waitReasonChanReceive：在 channel 进行读操作，会触发。</li>
<li>waitReasonChanSend：在 channel 进行写操作，会触发。</li>
<li>waitReasonFinalizerWait：在 finalizer 结束的阶段，会触发。在 Go 程序中，可以通过调用 <code>runtime.SetFinalizer</code> 函数来为一个对象设置一个终结者函数。这个行为对应着结束阶段造成的回收。</li>
</ul>
<h3 id="第七部分">第七部分</h3>
<table>
<thead>
<tr>
<th>标识</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>waitReasonForceGCIdle</td>
<td>force gc (idle)</td>
</tr>
<tr>
<td>waitReasonSemacquire</td>
<td>semacquire</td>
</tr>
<tr>
<td>waitReasonSleep</td>
<td>sleep</td>
</tr>
</tbody>
</table>
<ul>
<li>waitReasonForceGCIdle：强制 GC（空闲时间）结束时，会触发。</li>
<li>waitReasonSemacquire：信号量处理结束时，会触发。</li>
<li>waitReasonSleep：经典的 sleep 行为，会触发。</li>
</ul>
<h3 id="第八部分">第八部分</h3>
<table>
<thead>
<tr>
<th>标识</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>waitReasonSyncCondWait</td>
<td>sync.Cond.Wait</td>
</tr>
<tr>
<td>waitReasonTimerGoroutineIdle</td>
<td>timer goroutine (idle)</td>
</tr>
<tr>
<td>waitReasonTraceReaderBlocked</td>
<td>trace reader (blocked)</td>
</tr>
</tbody>
</table>
<ul>
<li>waitReasonSyncCondWait：结合 <code>sync.Cond</code> 用法能知道，是在调用 <code>sync.Wait</code> 方法时所触发。</li>
<li>waitReasonTimerGoroutineIdle：与 Timer 相关，在没有定时器需要执行任务时，会触发。</li>
<li>waitReasonTraceReaderBlocked：与 Trace 相关，ReadTrace会返回二进制跟踪数据，将会阻塞直到数据可用。</li>
</ul>
<h3 id="第九部分">第九部分</h3>
<table>
<thead>
<tr>
<th>标识</th>
<th>含义</th>
</tr>
</thead>
<tbody>
<tr>
<td>waitReasonWaitForGCCycle</td>
<td>wait for GC cycle</td>
</tr>
<tr>
<td>waitReasonGCWorkerIdle</td>
<td>GC worker (idle)</td>
</tr>
<tr>
<td>waitReasonPreempted</td>
<td>preempted</td>
</tr>
<tr>
<td>waitReasonDebugCall</td>
<td>debug call</td>
</tr>
</tbody>
</table>
<ul>
<li>waitReasonWaitForGCCycle：等待 GC 周期，会休眠造成阻塞。</li>
<li>waitReasonGCWorkerIdle：GC Worker 空闲时，会休眠造成阻塞。</li>
<li>waitReasonPreempted：发生循环调用抢占时，会会休眠等待调度。</li>
<li>waitReasonDebugCall：调用 GODEBUG 时，会触发。</li>
</ul>
<h2 id="总结">总结</h2>
<p>今天这篇文章是对开头 runtime.gopark 函数的详解文章的一个补充，我们能够对此了解到其诱发的因素。</p>
<p>主要场景为：</p>
<ol>
<li>通道（Channel）。</li>
<li>垃圾回收（GC）。</li>
<li>休眠（Sleep）。</li>
<li>锁等待（Lock）。</li>
<li>抢占（Preempted）。</li>
<li>IO 阻塞（IO Wait）</li>
<li>其他，例如：panic、finalizer、select 等。</li>
</ol>
<p>我们可以根据这些特性，去拆解可能会造成阻塞的原因。其实也就没必要记了，他们会导致阻塞肯定是由于存在影响控制流的因素，才会导致 gopark 的调用。</p>
<p>活学活用：）</p>


                                        
                                        
                                        
                                        <div class="rp4wp-related-posts">
                                            <h3>相关文章</h3>
                                            <ul>
                                                
                                                <li>
                                                    <div class="rp4wp-related-post-content">
                                                        <a
                                                            href="https://www.lican.site/posts/go/slice-discuss/">Go 切片这道题，吵了一个下午！</a>
                                                    </div>
                                                </li>
                                                
                                                <li>
                                                    <div class="rp4wp-related-post-content">
                                                        <a
                                                            href="https://www.lican.site/posts/go/117-errorstack/">Go1.17 新特性，优化抛出的错误堆栈</a>
                                                    </div>
                                                </li>
                                                
                                                <li>
                                                    <div class="rp4wp-related-post-content">
                                                        <a
                                                            href="https://www.lican.site/posts/go/117-performance/">Go1.17 新特性，凭什么提速 5~10%？</a>
                                                    </div>
                                                </li>
                                                
                                                <li>
                                                    <div class="rp4wp-related-post-content">
                                                        <a
                                                            href="https://www.lican.site/posts/go/117-module-pruning-lazy/">Go1.17 新特性：对 Go 依赖管理的一把大剪刀</a>
                                                    </div>
                                                </li>
                                                
                                                <li>
                                                    <div class="rp4wp-related-post-content">
                                                        <a
                                                            href="https://www.lican.site/posts/go/site-history/">分久必合，golang.org 将成为历史！</a>
                                                    </div>
                                                </li>
                                                
                                            </ul>
                                        </div>
                                        
                                        
                                    </div>

                                    
                                    
                                    

                                    
                                    <div class="post-meta">
                                        
                                        
                                        <div class="post-tags">
                                            <ul>
                                            
                                            <li>
                                                <a href="/tags/go" title="View all posts tagged match">go</a>
                                            </li>
                                            
                                            </ul>
                                        </div>
                                        
                                        
                                        <nav class="further-reading">
                                            
                                            <div class="previous">
                                                <span>&lt;&lt; Prev</span>
                                                <a href="https://www.lican.site/posts/go/117-errorstack/"
                                                    rel="prev">Go1.17 新特性，优化抛出的错误堆栈</a> </div>
                                            
                                            
                                            <div class="next">
                                                <span>Next >></span>
                                                <a href="https://www.lican.site/posts/go/slice-discuss/">Go 切片这道题，吵了一个下午！</a> 
                                            </div>
                                            
                                        </nav>
                                    </div>
                                    
                                    

                                    
                                    
                                    

                                </div>
                            </article>
                        </div>
                    </div>
                </section>
                <aside class="sidebar sidebar-primary" id="sidebar-primary" role="complementary">
    <h1 class="screen-reader-text">Sidebar</h1>
    

    
    
    <section id="text-2" class="widget widget_text">
        <div class="textwidget">
            
            <div id="profile">
                <div id="profile_picture"><img src="https://www.lican.site/logo/logo.png"></div>
                <div id="profile_intro">
                    <p><span class="name">Lican</span></p>
                    <p class="intro">全栈开发者，爱好造轮子。</p>
                </div>
            </div>
            
            <p>
                <script type="text/javascript">
                    (function ($) {
                        $(document).ready(function () {
                            var menuPrimaryContainer = $('#menu-primary-container');
                            var profile = $('#text-2');
                            $('#toggle-navigation').click(function () {
                                if (menuPrimaryContainer.hasClass('open')) {
                                    profile.removeClass('open');
                                } else {
                                    profile.addClass('open');
                                }
                            });
                        });
                    })(jQuery);
                </script>
            </p>
        </div>
    </section>
    
    
    
    
    
    <section id="text-5" class="widget widget_text">
        <h2 class="widget-title">开源项目</h2>
        <div class="textwidget">
            <div id="projects" style="line-height: 22px;">
                
                <a href="https://github.com/idoubi/gonews"
                    target="_blank">gonews</a>: &nbsp;Daily news for golang<br>
                
                <a href="https://github.com/idoubi/sql2struct"
                    target="_blank">sql2struct</a>: &nbsp;Generate go struct according to SQL<br>
                
                <a href="https://github.com/idoubi/goz"
                    target="_blank">goz</a>: &nbsp;Request library used in golang<br>
                
        </div>
    </section>
    
    

    
    
    
    
    

    
    
    

    
    
    

    
    
    
    
</aside>
            </div>
        </div>

        <footer id="site-footer" class="site-footer" role="contentinfo">
    <div class="max-width">
    </div>
    <div class="footer">
        <div id="footercontent">
            © lican.vip All rights reserved<br/>
            Built with Hugo Theme <a href="https://github.com/idoubi/hugo-theme-period" target="_blank">Period</a>
        </div>
    </div>
</footer>

<script>
    var _hmt = _hmt || [];
    (function() {
      var hm = document.createElement("script");
      hm.src = "https://hm.baidu.com/hm.js?e8351b6d4626d5881d439ea1f6184baa";
      var s = document.getElementsByTagName("script")[0]; 
      s.parentNode.insertBefore(hm, s);
    })();
</script>
    
    
    </div>
    
</body>

</html>